機會代幣列表
介面描述
取得AI透過多維度資料，追蹤當前行情下具有上漲潛力的代幣列表。
使用情境：
- 適用於當前行情下存在上漲行情機會的代幣篩選和查詢
- 適用於中短線交易者尋找具有上漲潛力的代幣標的
- 適用於趨勢跟蹤策略中辨識潛在上漲機會
使用提示：
- 自然語言輸入中長線投資、機會看漲、看漲、利多等词语時可查詢此介面
- 自然語言輸入上漲機會、看漲代幣等語言時可查詢此介面，回傳結果需注明機會看漲監控代幣
資料更新頻率：每5分鐘更新一次
請求 URL
- 方法：
POST - 路徑：
/open/v1/ai/getChanceCoinList
點數消耗
- 消耗點數：
6
前置條件
無前置條件，可直接呼叫。
請求參數
參數透過請求體（Body）以 JSON 格式傳遞。
無請求參數。
回應欄位
僅展示 data 陣列內每個物件的欄位結構：
| 欄位 | 類型 | 實際回傳類型 | 描述 |
|---|---|---|---|
| vsTokenId | long | string | 代幣 ID |
| symbol | string | string | 幣種符號 |
| price | number | string | 當前價格 (USD) |
| maxPrice | number | string | 歷史最高價格 (USD) |
| minPrice | number | string | 歷史最低價格 (USD) |
| percentChange1h | number | string | 1 小時價格變化百分比 |
| percentChange24h | number | string | 24 小時價格變化百分比 |
| percentChange7d | number | string | 7 天價格變化百分比 |
| percentChange30d | number | string | 30 天價格變化百分比 |
| percentChange60d | number | string | 60 天價格變化百分比 |
| percentChange90d | number | string | 90 天價格變化百分比 |
| cost | number | string | 主力成本價格 (USD) |
| costChange | number | string | 成本變化率 |
| deviation | number | string | 價格偏离度 (%) |
| marketCap | number | string | 市值 (USD) |
| marketCapRanking | integer | integer | 市值排名 |
| circulatingSupply | number | string | 流通供應量 |
| circulationRate | number | string | 流通率 (%) |
| active | integer | string | 24h 活跃位址數 |
| newly | integer | string | 24h 新增位址數 |
| tradeType | integer | integer | 交易類型（1:現貨 2:合約 3:交割合約） |
| chanceCoinTradeDataV1Vos | array | array | 交易時間資料列表 |
| timeRange | string | string | 時間範圍識別（如 m15, H4） |
| timeParticleEnum | integer | integer | 時間粒度列舉值 |
| tradeInflow | number | string | 交易淨流入金額 (USD) |
| tradeAmount | number | string | 交易總金額 (USD) |
| updateTime | long | long | 更新時間（毫秒時間戳） |
| pushPrice | number | string | 入場推送價格 (USD) |
| pushMaxPrice | number | string | 推送後最高價 (USD) |
| gains | number | number | 推送後漲幅 (%) |
| pushMinPrice | number | string | 推送後最低價 (USD) |
| declines | number | number | 推送後跌幅 (%) |
| score | number | number | AI 綜合評分 |
| scoreChange | number | number | 評分變化 |
| grade | integer | integer | 機會等級 |
| alpha | boolean | boolean | 是否 Alpha 訊號 |
| fomo | boolean | boolean | 是否 FOMO 狀態 |
| fomoEscalation | boolean | boolean | 是否 FOMO 加剧 |
| bullishRatio | number | number | 看漲情緒比例 |
| bearishRatio | number | number | 看跌情緒比例 |
欄位業務含義
以下欄位需要特別說明其業務含義和計算逻輯：
| 欄位 | 業務含義 | 範圍/計算方式 | 使用建議 |
|---|---|---|---|
| cost | 主力成本價格 | 依大額交易加權計算的主力持倉成本 | 當前價格低於成本價時可能是买入機會 |
| deviation | 價格偏离度 | (当前价格 - 主力成本) / 主力成本 * 100% | 負值表示低於成本，正值表示高於成本 |
| score | AI 綜合評分 | 範圍 0-100，基於資金流、技術指標等綜合計算 | 評分 < =45或評分>=80：待观察代幣；45 < 評分 < 55：观察代幣； 55 < 評分 < 80：機會代幣； |
| grade | 機會等級 | 範圍 1-3，3 為最高等級 | 等級越高表示風險越高 |
| pushPrice | 入場推送價格 | 系統首次推送該機會代幣時的價格 | 用於計算入場後的漲跌幅 |
| gains | 推送後漲幅 | (pushMaxPrice - pushPrice) / pushPrice * 100% | 推送後的最大漲幅 |
| declines | 推送後跌幅 | (pushPrice - pushMinPrice) / pushPrice * 100% | 推送後的最大跌幅 |
| alpha | Alpha 訊號 | 布尔值，表示是否具有超額收益潛力 | true 時關注度應更高 |
| fomo | FOMO 訊號 | 布尔值，表示市場情緒是否過热 | true 時需警惕追高風險 |
| fomoEscalation | FOMO 加剧 | 布尔值，FOMO 狀態進一步升級 | true 時風險顯著增加 |
| active | 24h 活跃位址數 | 過去 24 小時內有交易的鏈上位址數量 | 反映市場参與热度 |
| newly | 24h 新增位址數 | 過去 24 小時內首次持有該代幣的位址數量 | 反映新資金流入 |
| bullishRatio | 看漲情緒比例 | 範圍 0-1，基於社媒分析 | 越接近 1 表示市場越看漲 |
| bearishRatio | 看跌情緒比例 | 範圍 0-1，基於社媒分析 | 越接近 1 表示市場越看跌 |
| tradeInflow | 交易淨流入 | 正值為資金流入，負值為資金流出 | 持續正值表示主力在吸筹 |
列舉值說明
tradeType - 交易類型
| 值 | 含义 |
|---|---|
| 1 | 現貨 |
| 2 | 合約（永續） |
| 3 | 交割合約 |
timeParticleEnum - 時間粒度
| 值 | 含义 |
|---|---|
| 5 | 5 分鐘 |
| 15 | 15 分鐘 |
| 30 | 30 分鐘 |
| 101 | 1 小時 |
| 104 | 4 小時 |
| 124 | 24 小時 |
| 201 | 1 天 |
| 207 | 7 天 |
| 230 | 30 天 |
請求範例
json
{}cURL 範例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{}'cURL 範例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getChanceCoinList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{}"成功回應範例
json
{
"code": 200,
"message": "success",
"data": [
{
"vsTokenId": "23335", // 代币 ID
"symbol": "THE", // 币种符号
"price": "0.2792", // 当前价格
"maxPrice": "4.10318040169636", // 最高价格
"minPrice": "0.07220387483514598", // 最低价格
"percentChange1h": "0.32799907", // 1 小时价格变化百分比
"percentChange24h": "1.41729409", // 24 小时价格变化百分比
"percentChange7d": "4.48765177", // 7 天价格变化百分比
"percentChange30d": "7.90282167", // 30 天价格变化百分比
"percentChange60d": "25.65261453", // 60 天价格变化百分比
"percentChange90d": "56.36890614", // 90 天价格变化百分比
"cost": "0.270901516998264831", // 成本价格
"costChange": "0.0625", // 成本变化
"deviation": "-1.418662", // 偏离度
"marketCap": "36026970.954971075", // 市值
"marketCapRanking": 312, // 市值排名
"circulatingSupply": "128932942.41721758", // 流通供应量
"circulationRate": "39.535394", // 流通率
"active": "347", // 活跃地址
"newly": "347", // 新增地址
"tradeType": 1, // 交易类型（1:现货 2:合约 3:交割合约）
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15", // 时间范围
"timeParticleEnum": 15, // 时间范围枚举值
"tradeInflow": "460.6252600000001", // 交易净流入金额
"tradeAmount": "3213.5094600000007" // 交易金额
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-338.09664999999995",
"tradeAmount": "4455.511570000001"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-5145.618659999999",
"tradeAmount": "37250.337159999995"
}
// ... 更多数据省略
],
"updateTime": 1773016500000, // 更新时间
"pushPrice": "0.2621", // 推送价格
"pushMaxPrice": "0.2806", // 推送最高价
"gains": 0.0, // 涨幅
"pushMinPrice": "0.2587", // 推送最低价
"declines": 1.297215, // 跌幅
"score": 45.0, // 当前评分
"scoreChange": 10.0, // 评分变化
"grade": 2, // 等级
"alpha": false, // 是否 alpha
"fomo": false, // 是否 FOMO
"fomoEscalation": false, // 是否 FOMO 加剧
"bullishRatio": 1.0, // 看涨比例
"bearishRatio": 0.0 // 看跌比例
},
{
"vsTokenId": "1831",
"symbol": "BCH",
"price": "471.1",
"maxPrice": "4355.6201171875",
"minPrice": "75.0753135706",
"percentChange1h": "-0.01774485",
"percentChange24h": "2.29847208",
"percentChange7d": "2.79498224",
"percentChange30d": "-7.7764893",
"percentChange60d": "-24.54350443",
"percentChange90d": "-18.72153828",
"cost": "292.505855607332520866",
"costChange": "2.446914",
"deviation": "-35.698867",
"marketCap": "9404123107.056818",
"marketCapRanking": 11,
"circulatingSupply": "20006718.75",
"circulationRate": "95.270089",
"active": "22924",
"newly": "22924",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "-22417.999600000003",
"tradeAmount": "68195.44840000001"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-30667.368100000003",
"tradeAmount": "107622.5285"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-100288.20520000004",
"tradeAmount": "1847100.6466"
}
// ... 更多数据省略
],
"updateTime": 1773025800000,
"pushPrice": "450.1",
"pushMaxPrice": "475.6",
"gains": 0.0,
"pushMinPrice": "442.6",
"declines": 1.666296,
"score": 65.0,
"scoreChange": 10.0,
"grade": 1,
"alpha": false,
"fomo": false,
"fomoEscalation": false,
"bullishRatio": 0.5455,
"bearishRatio": 0.0
},
{
"vsTokenId": "23635",
"symbol": "FORM",
"price": "0.29",
"maxPrice": "4.190275115870975",
"minPrice": "0.14300383150589102",
"percentChange1h": "1.00325051",
"percentChange24h": "8.34645515",
"percentChange7d": "0.43961778",
"percentChange30d": "48.34304224",
"percentChange60d": "-22.25867739",
"percentChange90d": "0.63458821",
"cost": "0.939513805854359157",
"costChange": "-0.253266",
"deviation": "218.155708",
"marketCap": "112311811.6419909",
"marketCapRanking": 155,
"circulatingSupply": "381867255.144574",
"circulationRate": "65.839182",
"active": "164",
"newly": "164",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "-70934.94349000002",
"tradeAmount": "132642.78527"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-75774.15476000002",
"tradeAmount": "167235.10643999997"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-87347.62276",
"tradeAmount": "371051.104"
}
// ... 更多数据省略
],
"updateTime": 1773027600000,
"pushPrice": "0.2829",
"pushMaxPrice": "0.3109",
"gains": 0.0,
"pushMinPrice": "0.2627",
"declines": 7.140332000000001,
"score": 55.0,
"scoreChange": 10.0,
"grade": 1,
"alpha": false,
"fomo": false,
"fomoEscalation": false,
"bullishRatio": 0.5,
"bearishRatio": 0.0
}
// ... 更多数据省略
],
"requestId": "xxx-xxx-xxx"
}